home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 2002 November / SGI Freeware 2002 November - Disc 1.iso / dist / fw_enlightenment.idb / usr / freeware / catman / u_man / cat1 / enlightenment.Z / enlightenment
Text File  |  2001-10-09  |  65KB  |  1,651 lines
  1.  
  2.  
  3.  
  4. ENLIGHTENMENT(1)     Enlightenment Man Pages     ENLIGHTENMENT(1)
  5.  
  6.  
  7. NNNNAAAAMMMMEEEE
  8.        Enlightenment - The Window Manager that dares to    do what
  9.        others don't
  10.  
  11. WWWWAAAARRRRNNNNIIIINNNNGGGG
  12.        This documentation is automatically generated for you from
  13.        the online help documentation.  It is NOT to be considered
  14.        a full substitute for this documentation.  It may be
  15.        accessed    by middle clicking on your desktop and selecting
  16.        the "Help" item.     If you    are not    currently running
  17.        enlightenment, you may access this documentation    by
  18.        running the dox Help Browser To do this,    run
  19.        ENLIGHTENMENT_BIN/dox ENLIGHTENMENT_ROOT/E-docs (where BIN
  20.        and ROOT    are the    locations of your e binaries and shared
  21.        files, respectively)
  22.  
  23. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  24.        Enlightenment  version 0.16.5
  25.  
  26.        Topics: How To Use Documentation    About Enlightenment
  27.        Copyright Credits Website IRC Email
  28.  
  29.        User Documentation Frequently Asked Questions
  30.  
  31.        Welcome to the Enlightenment Documentation Viewer.  Please
  32.        select a    topic from the list.
  33.  
  34.        This Documentation is intended to take you step by step
  35.        through Enlightenment and its default setup, how    to use
  36.        it, modify settings, and    put it to use for you. When you
  37.        have finished reading each page please press the    NEXT
  38.        button on the top of this window    to go to the next page,
  39.        or use the Back button until you    have reached the Docs
  40.        Index
  41.  
  42.        If you are reading this right now you have managed to get
  43.        Enlightenment itself installed correctly    and are    either
  44.        running Enlightenment for the first time    or have    just
  45.        upgraded    to a new version. Congratulations. Now it's time
  46.        to take you on a    quick tour of the desktop you will have
  47.        before you.
  48.  
  49.        Please remember that if you use a theme other than the
  50.        default (Brushed    Metal) that it may look    slightly or
  51.        completely different to the contents of this User
  52.        Documentation. Some behavior may    also vary.
  53.  
  54.        To relaunch this    Help Browser at    any time, middle click on
  55.        your desktop and    select the "Help" Item.     The
  56.        documentation should come back up, reloading to the first
  57.        page.  You can also use the "Home" key to take you back to
  58.        the introduction    page at    any time during    the program.
  59.  
  60.        Enlightenment is    your Window Manager. The Window    Manager
  61.  
  62.  
  63.  
  64. 2000-09-28           Enlightenment 0.16.4            1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ENLIGHTENMENT(1)     Enlightenment Man Pages     ENLIGHTENMENT(1)
  71.  
  72.  
  73.        controls    the appearance of the borders of your windows,
  74.        their behavior and all user interaction with positioning,
  75.        killing,    resizing, moving, iconifying, shading etc. your
  76.        windows,    virtual    desktops, multiple desktops, menus
  77.        attached    to windows and some root window    menus and can
  78.        also control the    background of your _d_e_s_k_t_o_p(s).
  79.  
  80.        Enlightenment is    a large    and complex program and    is by no
  81.        means perfect, but it is    being worked on    and is as stable
  82.        as possible. It has many    advanced features, but may also
  83.        be missing some features    that you would like to see.  The
  84.        version you are now running (0.16.5) is by no means the
  85.        end of development and improvements, fixes and new
  86.        exciting    features are being worked on all the time. Please
  87.        visit the
  88.  
  89.        Web site    often for new versions,    fixes, patches and
  90.        updates.
  91.  
  92.        We hope that you    enjoy using Enlightenment as much as we
  93.        have enjoyed writing it.     We'd like to think that even if
  94.        this isn't the right software for you, you at least can
  95.        have fun    playing    around with what we have created.
  96.  
  97.        Copyright (C) 1997-2000 The Enlightenment Development Team
  98.  
  99.        Permission is hereby granted, free of charge, to    any
  100.        person obtaining    a copy of this software    and associated
  101.        documentation files (the    "Software"), to    deal in    the
  102.        Software    without    restriction, including without limitation
  103.        the rights to use, copy,    modify,    merge, publish,
  104.        distribute, sublicense, and/or sell copies of the
  105.        Software, and to    permit persons to whom the Software is
  106.        furnished to do so, subject to the following conditions:
  107.  
  108.        The above copyright notice and this permission notice
  109.        shall be    included in all    copies or substantial portions of
  110.        the Software.
  111.  
  112.        THE SOFTWARE IS PROVIDED    "AS IS", WITHOUT WARRANTY OF ANY
  113.        KIND, EXPRESS OR    IMPLIED, INCLUDING BUT NOT LIMITED TO THE
  114.        WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
  115.        PURPOSE AND NONINFRINGEMENT. IN NO EVENT    SHALL THE AUTHORS
  116.        BE LIABLE FOR ANY CLAIM,    DAMAGES    OR OTHER LIABILITY,
  117.        WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
  118.        ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR
  119.        THE USE OR OTHER    DEALINGS IN THE    SOFTWARE.
  120.  
  121.        Enlightenment has been written by:
  122.  
  123.        The Rasterman (Carsten Haitzler), Mandrake (Geoff
  124.        Harrison), Chutt    (Isaac Richards), Michael Jennings
  125.        (KainX),    Christian Kreibich (cK), Sung-Hyun Nam,    Kimball
  126.        Thurston, Michael Kellen, Frederic Devernay, Felix
  127.  
  128.  
  129.  
  130. 2000-09-28           Enlightenment 0.16.4            2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ENLIGHTENMENT(1)     Enlightenment Man Pages     ENLIGHTENMENT(1)
  137.  
  138.  
  139.        Bellaby,    Peter Kjellerstedt, Troy Pesola, Owen Taylor,
  140.        Stalyn, Knut Neumann, Nathan Heagy, Simon Forman, Brent
  141.        Nelson, Martin Tyler, Graham MacDonald, Jesse Michael,
  142.        Paul Duncan, Daniel Erat, Tom Gilbert, Peter Alm, Ben
  143.        FrantzDale, Hallvar Helleseth, Kameran Kashani, Carl
  144.        Strasen,    David Mason, Tom Christiansen And others (see
  145.        AUTHORS file).
  146.  
  147.        A big thanks to several companies that helped support
  148.        Enlightenment.
  149.  
  150.        Red Hat Software    (www.redhat.com) for allowing developers
  151.        resources and time to work on Enlightenment.
  152.  
  153.        VA Linux    Systems    (www.valinux.com) for providing    hardware,
  154.        bandwidth, Coke,    and the    patience to hire a couple of
  155.        loony bin candidates to work on something we (and
  156.        hopefully you) think is interesting.
  157.  
  158.        Xi Graphics (www.xig.com) for providing X servers to test
  159.        out code    on.
  160.  
  161.        Not only    should these people be thanked,    but the    whole E
  162.        community - those on the    E mailing list,    on #E on IRC on
  163.        openprojects.net    and all    E users    who have provided
  164.        feedback    and debugging information, bug-fixes, patches and
  165.        support.    A big thanks goes out to all of    you who    make a
  166.        project like this possible.
  167.  
  168.        In addition we'd    like to    thank several other projects -
  169.        such as XFree86,    Imlib, Esound, Freetype    and many others,
  170.        The people working on these equally important projects
  171.        should not be forgotten.
  172.  
  173.        For updated information on Enlightenment, development,
  174.        bug-fixes, snapshots of development versions etc. please
  175.        visit:
  176.  
  177.        http://www.enlightenment.org/
  178.  
  179.        You may want to visit this site often as    it changes
  180.        regularly with fixes and    development releases --    also
  181.        visiting    the daily-snapshots section on the FTP site is a
  182.        good idea (see the snapshots section on the website for
  183.        more information).
  184.  
  185.        There is    an Official Enlightenment IRC channel where you
  186.        can go and "hang    out" if    you want - talk    to other E users,
  187.        developers, get some help, drool    together, or whatever. #E
  188.        will kill me for    this but get onto any openprojects irc
  189.        server (irc.openprojects.net) then join #E. For example:
  190.  
  191.        epic4 your_nick irc.openprojects.net
  192.  
  193.  
  194.  
  195.  
  196. 2000-09-28           Enlightenment 0.16.4            3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. ENLIGHTENMENT(1)     Enlightenment Man Pages     ENLIGHTENMENT(1)
  203.  
  204.  
  205.        or
  206.  
  207.        irc your_nick irc.efnet.org
  208.  
  209.        or use your favorite graphical IRC client.
  210.  
  211.        Please remember that it can get busy with 100's of people
  212.        talking at once.     Not everyone is actually listening all
  213.        the time    or are in the middle of    a conversation.    Be polite
  214.        and patient, and    have a sense of    humor and you'll have
  215.        fun.
  216.  
  217.        CCCCVVVVSSSS CCCCoooommmmmmmmiiiitttt LLLLiiiisssstttt MMMMaaaaiiiillll
  218.  
  219.        To receive CVS Commit mails, please go to the CVS Commits
  220.        List mail page:
  221.        http://www.enlightenment.org/mailman/listinfo/cvs-commits-
  222.        list
  223.  
  224.        This mailing list does not accept user-submissions. It is
  225.        automatically generated email that is sent out whenever
  226.        the enlightenment CVS server receives a commit.    Sometimes
  227.        it can generate a lot of    email, sometimes it doesn't.
  228.  
  229.        DDDDeeeevvvveeeellllooooppppeeeerrrr MMMMaaaaiiiilllliiiinnnngggg LLLLiiiisssstttt
  230.  
  231.        If you would like to receive mail from the developer
  232.        mailing list, please go to the E-develop    Mailing    List mail
  233.        page: http://enlightenment.org/mailman/listinfo/e-develop.
  234.  
  235.        This mailing list is for    discussing Enlightenment and it's
  236.        development, bugs, feature requests, etc.  It is    not a
  237.        general chatter list.  The developers do    read this mailing
  238.        list and    will often comment on subjects brought up on the
  239.        list.
  240.  
  241.        WWWWeeeellllccccoooommmmeeee TTTToooo EEEEnnnnlllliiiigggghhhhtttteeeennnnmmmmeeeennnntttt
  242.  
  243.        Basic Intro Using Menus Mouse Bindings Mouse Configuration
  244.        Using The Window    Border Changing    Window Borders Default
  245.        Keybindings Multiple Desktops Changing Desktops Taking
  246.        Apps Between Desks The Dragbar The Pager    The Iconbox
  247.        Recovering Minimized Apps Remembering App Properties Intro
  248.        To Settings Window Groups
  249.  
  250.        Desktop Backgrounds Tooltips Audio Special Effects Setting
  251.        The Focus Moving    Windows    Resizing Windows Window
  252.        Operations Window Placement Options Autoraise Settings KDE
  253.        and GNOME Support Quick Intro to    IPC How    To Edit    Menus How
  254.        To Change Keybindings Themes Extra Eyecandy Maintenance
  255.        Scripts
  256.  
  257.        Now that    you have started Enlightenment,    if you are using
  258.        it for your desktop shell, your screen should look
  259.  
  260.  
  261.  
  262. 2000-09-28           Enlightenment 0.16.4            4
  263.  
  264.  
  265.  
  266.  
  267.  
  268. ENLIGHTENMENT(1)     Enlightenment Man Pages     ENLIGHTENMENT(1)
  269.  
  270.  
  271.        something like the image    here on    the left.
  272.  
  273.        Across the whole    top of the screen you will see a bar with
  274.        arrows pointing up and down on the left and right ends.
  275.        This is your desktop Dragbar .
  276.  
  277.        On the bottom-left you'll see 3 boxes. The top box with
  278.        the scrollbar attached will be your Iconbox.
  279.  
  280.        The other 2 boxes below it are Pagers for desktops 0 and
  281.        1. Everything else is your desktop background.
  282.  
  283.        Using Menus When    you click with your left mouse button on
  284.        the desktop background you will see an "User Menus" menu
  285.        appear (example displayed on the    right here).
  286.        Applications you    may have installed will    appear in this
  287.        menu. To    launch one of them simply select it from the
  288.        menu.
  289.  
  290.        Note: Menus in Enlightenment work like most menu    systems.
  291.        Either hold down    the mouse button and navigate with the
  292.        button down, releasing on the selection you want, or
  293.        release elsewhere to not    select anything. You can also
  294.        quickly click and release, then navigate: move the mouse,
  295.        and click again on the item you wish to select, or
  296.        elsewhere if you    do not wish to select an entry.
  297.  
  298.        To "stick" a menu up and    leave it up so you can select
  299.        items from it multiple times, click and hold down the
  300.        mouse and release on the    title of the menu (if it has one)
  301.        and it will remain up. You can move it and manipulate it
  302.        like a normal window. Close the window to unstick the
  303.        menu.
  304.  
  305.        Clicking    the middle button on the desktop background will
  306.        display Enlightenment's main menu. You can access the
  307.        other menus plus    more options from this menu (including
  308.        those to    log out, restart and display Help information).    A
  309.        sample of this menu is shown to our left.
  310.  
  311.        When you    click the right    mouse button a menu with the
  312.        title "Settings"    will appear. This is Enlightenment's
  313.        settings    menu. From it you can select various
  314.        configuration dialogs that will assist you in customizing
  315.        your desktop to better suit your    needs.
  316.  
  317.        Mouse Bindings Of course, when you click    on the desktop
  318.        background of your screen, normally you will bring up a
  319.        menu.  And of course, when you click on the border of a
  320.        window, you will    do various things.  But    these are not the
  321.        only things you can do with your    mouse.
  322.  
  323.        In Enlightenment, there are several other actions that the
  324.        mouse can do by default.     For example, by holding down the
  325.  
  326.  
  327.  
  328. 2000-09-28           Enlightenment 0.16.4            5
  329.  
  330.  
  331.  
  332.  
  333.  
  334. ENLIGHTENMENT(1)     Enlightenment Man Pages     ENLIGHTENMENT(1)
  335.  
  336.  
  337.        ALT key when you    click the left mouse button anywhere in    a
  338.        window, you will    find that you can move the window around
  339.        the screen, just    as if you had used the titlebar.  You can
  340.        also ALT    middle-click in    a window to resize it, or use ALT
  341.        and right-click to bring    up the Window Operations Menu.
  342.  
  343.        You will    find that holding down the ALT key while clicking
  344.        the middle mouse    button on the background of your desktop
  345.        will bring up a menu with the titles of all currently
  346.        active application windows. Selecting one of these will
  347.        take you    to that    application.  By using the CTRL    key
  348.        instead of ALT you will get a menu displaying all current
  349.        desktops    as sub-menus, with applications    on each    desktop
  350.        in the desktop sub-menu.
  351.  
  352.        MMMMoooouuuusssseeee CCCCoooonnnnffffiiiigggguuuurrrraaaattttiiiioooonnnn
  353.  
  354.        Enlightenment makes extensive use of the    mouse.    However,
  355.        you may be missing some features    because    of the way that
  356.        your mouse is configured    on your    X server.
  357.  
  358.        If your mouse does not have a middle button you should
  359.        enable "Emulate 3 Buttons" in your X server. This option
  360.        allows you to emulate a three-button mouse by pressing
  361.        both left and right mouse buttons at once.  If this does
  362.        not work, three-button emulation     may not be enabled. See
  363.        your X server documentation to configure    this emulation.
  364.  
  365.        This may    vary from system to system. The    OS and X server
  366.        may also    vary the method    in which you do    this, if it is
  367.        possible. Not having a middle mouse button in
  368.        Enlightenment, or for that matter X, is not a good thing
  369.        as it is    almost assumed to be there, and    is used    by many
  370.        applications, including E.
  371.  
  372.        If you have a Wheel-Mouse and X is configured to    use it,
  373.        Enlightenment supports it by default.
  374.  
  375.        Rolling your wheel up on    the desktop background will take
  376.        you back    a desktop . Rolling your wheel downward    you will
  377.        advance forward a desktop.
  378.  
  379.        If this doesn't work, then it may be you    haven't
  380.        configured your X server    to understand a    mouse with a
  381.        wheel. If you use XFree86 you may need to edit your
  382.        XF86Config to have a "Pointer" Section like:
  383.  
  384.        Section "Pointer"
  385.        Protocol    "MousemanPlusPS/2"
  386.        Device      "/dev/mouse"
  387.        ZAxisMapping    4 5
  388.        Buttons    5
  389.        EndSection
  390.  
  391.  
  392.  
  393.  
  394. 2000-09-28           Enlightenment 0.16.4            6
  395.  
  396.  
  397.  
  398.  
  399.  
  400. ENLIGHTENMENT(1)     Enlightenment Man Pages     ENLIGHTENMENT(1)
  401.  
  402.  
  403.        You may need to modify this for your mouse.
  404.  
  405.        Using the Window    Border When you    start an application,
  406.        unless it has special properties, it will come up on your
  407.        screen with a border surrounding    it that    contains a
  408.        titlebar    and several control buttons.  This border is the
  409.        primary interface to controlling    an application window.
  410.        The Default setup (shown    on the next page) gives    adequate
  411.        control but still retains simplicity.
  412.  
  413.        If you click left mouse button on the titlebar and keep
  414.        the mouse button    down the window    will follow your mouse
  415.        wherever    it moves. Respectively if you click your left
  416.        mouse button and    drag on    any of the resize handles, the
  417.        window will be resized in that direction. Clicking right
  418.        mouse button on the resize handles will raise the windows
  419.        to the top.
  420.  
  421.        Clicking    right mouse button on the titlebar or any button
  422.        on the window operations    menu button on the top-left will
  423.        display a menu that has window manipulation options in it.
  424.  
  425.        Double-Clicking (clicking the mouse twice in succession
  426.        really fast) will make the Window shade or unshade
  427.        (depending if it    was unshaded or    shaded to start    with).
  428.  
  429.        Clicking    left mouse button on the iconify button    will
  430.        iconify the window and send it off to the Iconbox .
  431.        Hitting the Maximize button will    maximize the size of the
  432.        application fill    your screen. Hitting it    again will
  433.        Unmaximize, bringing the    window back to its normal size.
  434.  
  435.        Clicking    with the left mouse button on the close    button
  436.        will close the window.  If the application that owns that
  437.        window does not respond to a nice request to exit, then
  438.        press the right mouse button on the close button    to
  439.        forcibly    terminate that window. This should not be used
  440.        unless the application is visibly "hung".
  441.  
  442.        In addition to these methods, there are additional ways to
  443.        manipulation windows.
  444.  
  445.        If you hold down    the ALT    key and    hold down left mouse
  446.        button anywhere in the window (on the border OR in the
  447.        application part) while dragging, you will move this
  448.        window around. Doing the    same but with the middle mouse
  449.        button will resize the window in    that direction.    Clicking
  450.        the right mouse button anywhere in the window while
  451.        holding down the    ALT key    will bring up the window
  452.        operations menu.
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460. 2000-09-28           Enlightenment 0.16.4            7
  461.  
  462.  
  463.  
  464.  
  465.  
  466. ENLIGHTENMENT(1)     Enlightenment Man Pages     ENLIGHTENMENT(1)
  467.  
  468.  
  469.        CCCChhhhaaaannnnggggiiiinnnngggg    WWWWiiiinnnnddddoooowwww BBBBoooorrrrddddeeeerrrrssss
  470.  
  471.        From time to time you may find that you don't like a
  472.        particular border that a    window uses, for some reason or
  473.        another.     You can easily    change the border style    of a
  474.        window in Enlightenment using the
  475.  
  476.        Window Operations menu, however.     Select    the "Set Border
  477.        Style" menu, and    a list will be presented to you    of
  478.        available borders in this theme.     The most common use for
  479.        this is to make an application shed its border, using the
  480.        BORDERLESS border type.
  481.  
  482.        You can always click with ALT + Right mouse button
  483.        anywhere    in the window to bring up the window operations
  484.        menu again.
  485.  
  486.        If you want to remember the border style    for the    next time
  487.        you run this application, you can always    use the    Remember
  488.        dialog to remember the current window border.
  489.  
  490.        DDDDeeeeffffaaaauuuulllltttt KKKKeeeeyyyybbbbiiiinnnnddddiiiinnnnggggssss
  491.  
  492.        Below are the keybindings for E as it comes "from the
  493.        factory"
  494.  
  495.        CTRL+ALT+Home - Re-shuffle windows on screen to be Clean
  496.  
  497.        CTRL+ALT+Del - Exit Enlightenment and Log Out
  498.  
  499.        CTRL+ALT+End - Restart Enlightenment
  500.  
  501.        CTRL+ALT+Up-Arrow - Raise window    to top
  502.  
  503.        CTRL+ALT+Down-Arrow - Lower window to the bottom
  504.  
  505.        CTRL+ALT+Left-Arrow - Go    to the previous    desktop
  506.  
  507.        CTRL+ALT+Right-Arrow - Go to the    next desktop
  508.  
  509.        CTRL+ALT+X - Close the currently    focused    window
  510.  
  511.        CTRL+ALT+K - Kill the currently focused window nastily
  512.  
  513.        CTRL+ALT+R - Shade/Unshade the currently    focused    window
  514.  
  515.        CTRL+ALT+I - Iconify the    currently focused window
  516.  
  517.        CTRL+ALT+R - Shade/Unshade the currently    focused    window
  518.  
  519.        CTRL+ALT+S - Stick/Unstick the currently    focused    window
  520.  
  521.        CTRL+ALT+(F1 - F12) - Go    directly to desktops 0 - 11
  522.  
  523.  
  524.  
  525.  
  526. 2000-09-28           Enlightenment 0.16.4            8
  527.  
  528.  
  529.  
  530.  
  531.  
  532. ENLIGHTENMENT(1)     Enlightenment Man Pages     ENLIGHTENMENT(1)
  533.  
  534.  
  535.        ALT+Tab - Switch    focus to the next window
  536.  
  537.        ALT+Enter - Zoom/Unzoom the currently focused window
  538.  
  539.        SHIFT+ALT+Left-Arrow - Move to the virtual desktop on the
  540.        left if there is    one
  541.  
  542.        SHIFT+ALT+Right-Arrow - Move to the virtual desktop on the
  543.        right if    there is one
  544.  
  545.        SHIFT+ALT+Up-Arrow - Move to the    virtual    desktop    above if
  546.        there is    one
  547.  
  548.        SHIFT+ALT+Down-Arrow - Move to the virtual desktop below
  549.        if there    is one
  550.  
  551.        Note: Zooming in    and out    of windows will    only work if you
  552.        have an XFree86 server or one that implements the
  553.        Xf86VidMode extension. You also need to define lots of
  554.        screen modes for    your display, so ensure    your "Display"
  555.        subsection of your XF86Config looks like:
  556.  
  557.        SubSection "Display"
  558.            Depth 16
  559.            Modes "1600x1200" "1280x1024" "1152x864"    "1024x768" "800x600" "640x480" "512x384" "400x300" "320x240"
  560.        EndSubSection
  561.  
  562.        Have a "Display"    subsection per depth (this example is for
  563.        16 bit) and all the resolutions defined as above.
  564.  
  565.        Multiple    & Virtual Desktops
  566.  
  567.        Enlightenment supports both Multiple and    Virtual    desktops.
  568.        There are distinct difference between the two, and
  569.        Enlightenment treats them differently.
  570.  
  571.        When you    start Enlightenment you    will by    default    have two
  572.        desktops. In Enlightenment desktops are geometrically
  573.        unrelated work areas. They are visually stacked on top of
  574.        each other and can even be dragged down to expose desktops
  575.        underneath.
  576.  
  577.        The best    way to imagine this is that each desktop is a
  578.        sheet of    paper with the first desktop (desktop 0) being
  579.        glued in-place. You can re-shuffle the stack of papers and
  580.        slide one down to reveal    a piece    of paper underneath - the
  581.        only paper you can't slide is the first one. Each desktop
  582.        (or sheet) contains your    application windows.
  583.  
  584.        Windows normally    live on    one desktop, but can be    made to
  585.        exist on    all desktops - whenever    you change to a    new
  586.        desktop the window will follow you and be on that desktop
  587.        too. This is known as being sticky.  if a window    is sticky
  588.        it will "stick to the glass of your screen" and stay there
  589.  
  590.  
  591.  
  592. 2000-09-28           Enlightenment 0.16.4            9
  593.  
  594.  
  595.  
  596.  
  597.  
  598. ENLIGHTENMENT(1)     Enlightenment Man Pages     ENLIGHTENMENT(1)
  599.  
  600.  
  601.        until it    is not sticky anymore or the window is closed.
  602.  
  603.        Virtual desktops    (also known as desktop areas) is a
  604.        measure of how big your desktops    are. A desktop can be a
  605.        multiple    of your    screen size in size (2x1, 2x2, 3x3, 4x2
  606.        etc.). That means each desktop has an AxB screen    size of
  607.        area allocated to it and    you can    be looking at any screen-
  608.        sized part of it    at any time. It's just like getting more
  609.        sheets of paper and taping them to the sides of your
  610.        current sheet of    paper. An easy way of changing your view
  611.        is by just sliding your mouse in    the direction of a
  612.        currently unviewable part of your desktop. As long as you
  613.        have Edge Flip enabled Enlightenment will automatically
  614.        scroll over to that part    of the desktop.
  615.  
  616.        To change the number of virtual desktops    that you have,
  617.        use the "Multiple Desktop Settings" dialog from the right
  618.        mouse settings menu .  You should see a menu that looks
  619.        something like the menu to the right.  You can use the
  620.        slider bar to quickly select the    appropriate number of
  621.        virtual desktops    you would like to use.
  622.  
  623.        To change the number of virtual areas, use the "Virtual
  624.        Desktop Settings" menu.    This will bring    up a menu that
  625.        looks something like the    one on the left.  Use the slider
  626.        bars to extend the size of the virtual areas to the size
  627.        that you    prefer.    You can    also use this dialog to
  628.        enable/disable edge resistance (when your mouse hits the
  629.        edge of an area)    moving between virtual areas.
  630.  
  631.        Enlightenment also allows you to    set a different    desktop
  632.        backdrop    per desktop to help you    customize your
  633.        environment and differentiate which desktop is which.
  634.  
  635.        An easy way of having Enlightenment automatically pick up
  636.        any pictures you    have is    to make    a directory in your
  637.        ~/.enlightenment    directory called backgrounds and then
  638.        fill that with your favorite backdrops. Enlightenment will
  639.        automatically discover this and index them for you
  640.        allowing    you to select them and change their settings.
  641.        More on this topic is explained in the Desktop Backgrounds
  642.        section.
  643.  
  644.        CCCChhhhaaaannnnggggiiiinnnngggg    DDDDeeeesssskkkkttttooooppppssss
  645.  
  646.        There are several ways that you can change your current
  647.        desktop - let's go over a few of    them here.
  648.  
  649.        You can use the Keybindings alt-F1 through alt-F12 for the
  650.        first 12    desktops.  You can use the Keybindings Ctrl-Alt-
  651.        Left and    Ctrl-Alt-Right to navigate to the next/previous
  652.        desktop.     You can use the Keybindings shift-alt-
  653.        directional arrow to change virtual areas in a given
  654.        direction.  You can use the Pager to quickly navigate to
  655.  
  656.  
  657.  
  658. 2000-09-28           Enlightenment 0.16.4               10
  659.  
  660.  
  661.  
  662.  
  663.  
  664. ENLIGHTENMENT(1)     Enlightenment Man Pages     ENLIGHTENMENT(1)
  665.  
  666.  
  667.        the desktop/area    you want by clicking on    the desired area.
  668.        You can use the Dragbar to quickly navigate to a
  669.        particular application or a particular desktop by using
  670.        the middle and right mouse buttons.  You    can also use
  671.        external    applications such as the GNOME panel's pager or
  672.        the KDE panel's pager to    navigate desktops and/or
  673.        applications.  You will need to enable Desktop Support for
  674.        these to    work.
  675.  
  676.        MMMMoooovvvviiiinnnngggg AAAApppppppplllliiiiccccaaaattttiiiioooonnnnssss BBBBeeeettttwwwweeeeeeeennnn DDDDeeeesssskkkkttttooooppppssss
  677.  
  678.        There are several ways that you can move    applications from
  679.        one desktop to another.    We'll go over a    few of them now.
  680.  
  681.        The first way you can move apps between desktops    is using
  682.        the Pager.
  683.  
  684.        You can also move applications between desktops using the
  685.        Dragbar.
  686.  
  687.        You can also move applications between desktops using the
  688.        KDE or GNOME desktop pagers.
  689.  
  690.        You can also move a window, then    bring the window with you
  691.        as you change desktops using keybinding.     =head2    The
  692.        Dragbar
  693.  
  694.        If you look along the top of your screen, you will notice
  695.        a long thin bar that looks something like the bar pictured
  696.        below.  This is called your Dragbar.  It    gets its name
  697.        from its    primary    purpose, which is dragging desktops
  698.        around.
  699.  
  700.        If you are on any desktop except    desktop    0, you can pick
  701.        up and move that    desktop    in another direction.  Desktops
  702.        documentation has more information on how to change
  703.        desktops.  Once you have    dragged    a desktop down,    you can
  704.        proceed to move windows between desktops    this way, instead
  705.        of using    the pager.
  706.  
  707.        You can also use    the Dragbar to retrieve    windowlists.  Use
  708.        the middle mouse    button to retrieve a windowlist, and the
  709.        right mouse button for a    windowlist sorted by desktops.
  710.  
  711.        The Pager Pagers    may not    be a new idea in desktop
  712.        environments, but the Pager in Enlightenment (as    seen on
  713.        the right) is a highly advanced and highly configurable
  714.        tool for    desktop    and window control, as well as a
  715.        navigation tool.
  716.  
  717.        The pager lets you see your desktop screen area in
  718.        miniature. It lets you click on a certain desktop to
  719.        "visit" it, click and drag windows around in the    pager
  720.        itself to move them about the screen quickly, or    between
  721.  
  722.  
  723.  
  724. 2000-09-28           Enlightenment 0.16.4               11
  725.  
  726.  
  727.  
  728.  
  729.  
  730. ENLIGHTENMENT(1)     Enlightenment Man Pages     ENLIGHTENMENT(1)
  731.  
  732.  
  733.        desktops. In this example, we have two virtual areas.  You
  734.        can see the current area    (the one with the windows in it)
  735.        is also highlighted.
  736.  
  737.        Dragging    a window from one area of a pager to another will
  738.        move it there, or to another desktop.  Dragging it out
  739.        onto the    actual desktop will drop that window right there.
  740.        You can also drag a window into the Iconbox to iconify the
  741.        window.
  742.  
  743.        Pressing    right-mouse button over    a blank    portion    of the
  744.        pager gets you the pager    menu, allowing you to change
  745.        settings.  This will allow you to set a couple of quick
  746.        options,    as shown on the    left.  For more    available
  747.        options,    you can    select the "Pager Settings" item, and
  748.        another dialog will pop up, that    looks like the one below.
  749.  
  750.        This dialog box will allow you to set all sorts of
  751.        additional parameters, many of which can    increase the
  752.        performance of Enlightenment on your system.  Disabling
  753.        high quality snapshots and/or snapshots in general as well
  754.        as continuous updates can seriously improve performance -
  755.        these features are intended for high end    machines.
  756.  
  757.        You can resize the pager    to make    it the size you'd like.
  758.        Hold down ALT and use the middle-mouse button to    resize
  759.        the pager in any    direction. Using left-mouse button while
  760.        holding ALT and dragging    will move the window. Holding
  761.        down ALT    while pressing right-mouse button, just    like any
  762.        normal window will get you a window operations menu.
  763.  
  764.        In the default theme clicking the tab on    the right side of
  765.        the pager with the arrow    pointing right will shade and
  766.        unshade the pager window    horizontally, allowing you to
  767.        hide and    unhide the window easily.
  768.  
  769.        The striped area    above this tab on the pager's border is    a
  770.        handle that will    allow you to move the pager about, just
  771.        like the    titlebar of any    window.
  772.  
  773.        TTTThhhheeee IIIIccccoooonnnnbbbbooooxxxx
  774.  
  775.        The iconbox is the place    the icons for all your iconified
  776.        windows go.  It is one method of    recovering minimized
  777.        applications.  Whenever you iconify or minimize a window
  778.        it will go into an iconbox and have an icon displayed for
  779.        it there. Clicking on the icon again will de-iconify it.
  780.  
  781.        You can have as many icon boxes on your desktop as you
  782.        want to.     You can create    more by    using the Middle Click
  783.        Menu - select Desktop->Create New Iconbox and a new
  784.        Iconbox will pop    up on your desktop.  Each of these
  785.        Iconboxes can have individual configurations, as    detailed
  786.        on the next page.
  787.  
  788.  
  789.  
  790. 2000-09-28           Enlightenment 0.16.4               12
  791.  
  792.  
  793.  
  794.  
  795.  
  796. ENLIGHTENMENT(1)     Enlightenment Man Pages     ENLIGHTENMENT(1)
  797.  
  798.  
  799.        You can move the    Iconbox    around the screen using    Alt-
  800.        Leftclick on the    window,    and then moving    it to the desired
  801.        location    on the screen.    You can    resize the Iconbox by
  802.        alt-middleclicking on the window    and then adjusting the
  803.        size  as    described in the Mouse Bindings    section.
  804.  
  805.        Clicking    the right-mouse    button anywhere    in the Iconbox
  806.        will bring up a menu to configure that iconbox.    This menu
  807.        will look a little something like the one here to the
  808.        right.  This menu allows    you to also close the Iconbox or
  809.        open up an additional Iconbox.
  810.  
  811.        To change the settings of an individual Iconbox,    we'll use
  812.        the right mouse button menu and select "This Iconbox
  813.        Settings" - this    should get us a    dialog that looks
  814.        something like the one  to our left.  You can change the
  815.        orientation, icon size, scrollbar options, display policy,
  816.        base image, and many more options of the    Iconbox    from this
  817.        dialog.    You may    choose to change the anchor of alignment
  818.        for resizes - play with it until    it resizes appropriately
  819.        for your    Iconbox    location.
  820.  
  821.        If you want to customize    the images used    for the    icons in
  822.        your iconbox, there is already an example configuration
  823.        supplied. To make your own configuration    copy the
  824.        icondefs.cfg file installed in your Enlightenment system
  825.        config directory
  826.        (/usr/local/enlightenment/config/icondefs.cfg or
  827.        /usr/share/enlightenment/config/icondefs.cfg) to    your
  828.        ~/.enlightenment    directory and then edit    it. On each line
  829.        you will    find 4 fields. The first field is the image file
  830.        to be used. The image is    searched for in    the usual search
  831.        path if it is not an absolute path to the image file. The
  832.        search path is in order:    ~/.enlightenment, THEME_DIR/,
  833.        ENLIGHTENMENT_ROOT/config.
  834.  
  835.        The second field    on the line is a shell-glob like match
  836.        for the title of    a window.  If this field is irrelevant,
  837.        NULL is used instead. NB: the only valid    wildcard in the
  838.        glob pattern is "*". The    third field is the NAME    property
  839.        of the window and the fourth is the CLASS. The order of
  840.        search priority is last to first, so the    last entry in the
  841.        file that matches a window's title, name    and class globs
  842.        will use    the icon image defined on the first line.
  843.  
  844.        If you want all windows to have an icon then use:
  845.  
  846.        "pix/pimage.png"    NULL NULL NULL
  847.  
  848.        This is the most    general    match for an icon and will match
  849.        ALL windows. If you use this make sure it's at the start
  850.        of the file so it will only match if no other matches are
  851.        found.
  852.  
  853.  
  854.  
  855.  
  856. 2000-09-28           Enlightenment 0.16.4               13
  857.  
  858.  
  859.  
  860.  
  861.  
  862. ENLIGHTENMENT(1)     Enlightenment Man Pages     ENLIGHTENMENT(1)
  863.  
  864.  
  865.        There are several examples of using the globbing    and
  866.        matching    in the system icondefs.cfg file. Use that as a
  867.        reference for your own additions.
  868.  
  869.        RRRReeeeccccoooovvvveeeerrrriiiinnnngggg MMMMiiiinnnniiiimmmmiiiizzzzeeeedddd AAAApppppppplllliiiiccccaaaattttiiiioooonnnnssss
  870.  
  871.        There are several ways to recover an application    once you
  872.        have minimized it.  The most obvious way    is to use the
  873.        Iconbox .  Of course, you might have had    some applications
  874.        in your Iconbox when you    accidentally closed it.     Or maybe
  875.        you minimized some applications and forgot you didn't have
  876.        an Iconbox.  Or maybe you don't like the    Iconbox    and
  877.        usually use KDE or GNOME's panel    to recover them    and
  878.        forgot to launch    them.  Never fear.  You    can always middle
  879.        click on    the Dragbar and    get a menu that    will allow you to
  880.        recover them.  You can also Alt or Ctrl-Middleclick on the
  881.        desktop to get the same menus (in case you don't    have a
  882.        Dragbar anymore).
  883.  
  884.        Remember, at any    time you can always create a new Iconbox
  885.        to catch    your applications as they minimize, if you want
  886.        to re-enable it.     Unfortunately you'll have to reconfigure
  887.        it since    each Iconbox can have its own settings.
  888.  
  889.        Remembering Application Properties In the window
  890.        operations menu of every    window you will    see an entry
  891.        labeled "Remember...". If you select this it will bring up
  892.        the "Remember" dialog for that window (Note: only one of
  893.        these dialogs can be active at any one time), as    shown to
  894.        our right.
  895.  
  896.        This dialog lets    you selectively    snapshot certain
  897.        attributes of that window at that time and have
  898.        Enlightenment remember them. You    may choose to only
  899.        remember    some of    the attributes,    and possibly not have the
  900.        application started automatically for you. Choose what you
  901.        want Enlightenment to remember about that window    and hit
  902.        "Apply" or "OK" if you don't need the dialog anymore, and
  903.        Enlightenment will, the next time that instance of the
  904.        application is run, apply the current location, size,
  905.        border style or any other attribute to that window.
  906.        Enlightenment can also launch the application for you upon
  907.        startup if you so wish.
  908.  
  909.        Settings    When you click the right mouse button on the
  910.        desktop background you will pop up the Settings menu. From
  911.        here you    can select an aspect of    Enlightenment to
  912.        configure to your liking. There are too many settings to
  913.        actually    document fully right now, but the likelihood is
  914.        if you want a particular    behavior from Enlightenment, it
  915.        is achievable by    merely playing with these options.
  916.  
  917.        Combinations of options are often required to get the
  918.        effect you want,    so some    experimentation    may be required.
  919.  
  920.  
  921.  
  922. 2000-09-28           Enlightenment 0.16.4               14
  923.  
  924.  
  925.  
  926.  
  927.  
  928. ENLIGHTENMENT(1)     Enlightenment Man Pages     ENLIGHTENMENT(1)
  929.  
  930.  
  931.        Do not be frightened. Nothing you can do    can't be undone
  932.        by simply changing the options back to how they were and
  933.        clicking    on Apply again.
  934.  
  935.        WWWWiiiinnnnddddoooowwww GGGGrrrroooouuuuppppssss
  936.  
  937.        Sometimes you have a number of windows on your desktop
  938.        that logically go together. Enlightenment allows    you to
  939.        group windows together, so that whenever    you change a
  940.        property    of one window in a group, the change is    reflected
  941.        on the other group members. If you have a group whose
  942.        members span multiple desktops ,    changing a group's
  943.        property    affects    only windows of    that group that    are on
  944.        the current desktop.
  945.  
  946.        The properties that you can change for an entire    group
  947.        include setting the window border, iconifying, killing,
  948.        moving, raising/lowering, sticking and shading of a
  949.        window.
  950.  
  951.        To define what properties are applied to    a group    by
  952.        default,    you go to the settings menu and    pick the "Group
  953.        Settings" option, which will give you a dialog window in
  954.        which you can configure the settings, as    shown here on the
  955.        right.
  956.  
  957.        There are two different methods for manipulating    window
  958.        groups. First, there's a    comprehensive submenu available
  959.        in each window's    operations menu    called "Window Groups".
  960.        This menu is shown here on the right.  You also are able
  961.        to configure the    group individually apart from the default
  962.        group settings (as shown    on the previous    page).
  963.  
  964.        The second way is the window titlebar, which has    the most
  965.        important options directly available for    convenience.
  966.        Shift-click to start a group, Ctrl-clicking to add a
  967.        window to the youngest group (also referred to as the
  968.        "current" group)    and Shift-Ctrl-Click to    destroying a
  969.        group. You can also click the middle mouse button for
  970.        visualizing the _g_r_o_u_p(s)    of a window. Click again to
  971.        returning to the    previous border.
  972.  
  973.        Windows can be in multiple groups at the    same time, so for
  974.        many options you    have to    indicate which group you are
  975.        referring to.  Selecting    the appropriate    checkboxes
  976.        (showing    the group members' titles) at the top of the
  977.        dialog windows.
  978.  
  979.        Selecting and Adding backgrounds
  980.  
  981.        Often you will want to change the background of a
  982.        particular desktop.  There are several ways you can do
  983.        this.  But of course, to    change your desktop, you'll need
  984.        to give Enlightenment some graphics to play with.  A
  985.  
  986.  
  987.  
  988. 2000-09-28           Enlightenment 0.16.4               15
  989.  
  990.  
  991.  
  992.  
  993.  
  994. ENLIGHTENMENT(1)     Enlightenment Man Pages     ENLIGHTENMENT(1)
  995.  
  996.  
  997.        desktop theme may add a background or two to your
  998.        available selections, but most users want to have even
  999.        backgrounds to choose from.  To add backgrounds to your
  1000.        selection, make a backgrounds directory under your home
  1001.        directory.  To do this using most shells    you can    type
  1002.  
  1003.        mkdir ~/.enlightenment/backgrounds
  1004.  
  1005.        Once you've done    this, you should restart Enlightenment -
  1006.        this can    be done    quickly    and easily by simply hitting the
  1007.        Ctrl-Alt-End key    combination.  When Enlightenment starts
  1008.        up, it will rescan these    directories, and add new files
  1009.        into the    background selector.
  1010.  
  1011.        Once you    have added your    backgrounds and    restarted
  1012.        Enlightenment, you should be able to go to the root menu
  1013.        desktop selector.  To get to this menu, middle click on
  1014.        the desktop, select "Desktop", and go to    Backgrounds.  You
  1015.        should get something that looks similar to the image  on
  1016.        the right.  From    here you will be able to navigate the
  1017.        backgrounds menus.
  1018.  
  1019.        (Click next for more information)
  1020.  
  1021.        Once you    have opened up the backgrounds menu, you should
  1022.        see something similar to    the image below.  From here, you
  1023.        can put your mouse over any of the images there,    and it
  1024.        will change the desktop background of the current desktop
  1025.        to the image that you have selected.
  1026.  
  1027.        Enlightenment will attempt to choose the    best settings for
  1028.        a particular background,    but if it gets it wrong    you can
  1029.        always change the settings by hand.  By bringing    up the
  1030.        settings    menu with the right mouse button and selecting
  1031.        the "Desktop Background Settings" item, you can bring up    a
  1032.        dialog that looks something like    the one    on the next page
  1033.        . ..
  1034.  
  1035.        You can use this    dialog to change your background, too ,
  1036.        as well as fine-tune all    the various settings for each
  1037.        individual background available.
  1038.  
  1039.        TTTToooooooollllttttiiiippppssss
  1040.  
  1041.        From time to time, as you use Enlightenment, if you don't
  1042.        remember    what does what,    if you keep the    mouse still for    a
  1043.        little bit a tooltip will pop up.  The easiest example of
  1044.        this is when you    hold the mouse over a Window Border.
  1045.  
  1046.        You can disable the tooltips or change the delay    before
  1047.        they pop    up by selecting    the "Tooltip Settings" dialog
  1048.        from the    settings menu, as shown    here on    the left.
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054. 2000-09-28           Enlightenment 0.16.4               16
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060. ENLIGHTENMENT(1)     Enlightenment Man Pages     ENLIGHTENMENT(1)
  1061.  
  1062.  
  1063.        AAAAuuuuddddiiiioooo
  1064.  
  1065.        Of course, Enlightenment    comes preconfigured to play lots
  1066.        of little blips and beeps when you do various things on
  1067.        your desktop.  In order to use sound in Enlightenment, you
  1068.        must have both ESounD and audiofile installed.  You can
  1069.        find more information about these libraries from
  1070.        http://www.gnome.org.
  1071.  
  1072.        You can enable and/or disable sound at runtime simply by
  1073.        selecting from the Settings menu    the "Audio Settings"
  1074.        option, which brings up a dialog, shown here at right.
  1075.  
  1076.        SSSSppppeeeecccciiiiaaaallll EEEEffffffffeeeeccccttttssss
  1077.  
  1078.        Enlightenment has many features that are    configured via
  1079.        the "Special FX"    settings dialog.  Here you can configure
  1080.        the Dragbar , various sliding speeds (including the speed
  1081.        of a windowshade), as well as toggle animation of
  1082.        different features.  You    can also configure the method
  1083.        used for    sliding    windows, similar to resize modes .
  1084.  
  1085.        There are several FX features disabled by default in a new
  1086.        installation, including the animated display of menus.
  1087.        You can also enable saveunders here, which may improve or
  1088.        slow down the performance of Enlightenment on your X
  1089.        server, depending on server and configuration.
  1090.  
  1091.        Setting the Focus
  1092.  
  1093.        Enlightenment offers lots of different options for
  1094.        focusing    windows.  By default, it comes up in sloppy focus
  1095.        mode.  There are    two other primary focus    modes supported
  1096.        by Enlightenment    - click    to focus and pointer focus.
  1097.  
  1098.        Click To    Focus most people are familiar with.  You click
  1099.        on a window and it receives the focus from Enlightenment.
  1100.  
  1101.        Pointer Focus gives the focus to    whichever window the
  1102.        pointer is sitting over
  1103.  
  1104.        Sloppy Focus is similar to Pointer Focus, except    that if
  1105.        you go over the desktop background you still are    focused
  1106.        on the last window
  1107.  
  1108.        Next we'll tell you how to change these settings.
  1109.  
  1110.        Enlightenment allows you    to change your focus settings at
  1111.        any time.  Simply bring up the Settings menu and    then
  1112.        select "Focus Settings" to bring    up a dialog that looks
  1113.        something like the one on the right.  At    the top, we can
  1114.        select between our three    focus modes, as    described on the
  1115.        previous    page.
  1116.  
  1117.  
  1118.  
  1119.  
  1120. 2000-09-28           Enlightenment 0.16.4               17
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126. ENLIGHTENMENT(1)     Enlightenment Man Pages     ENLIGHTENMENT(1)
  1127.  
  1128.  
  1129.        We can also enable some other features, such as one that
  1130.        will allow a simple mouse click to raise    any window to the
  1131.        foreground, as well as several other advanced focus
  1132.        settings.
  1133.  
  1134.        Here we can also    enable the focuslist feature.  This
  1135.        feature requires    Xkb to be enabled in your X server.  If
  1136.        you don't have Xkb enabled, please consult your X server
  1137.        documentation to    see how    to do this.  The focuslist is a
  1138.        window list that    pops up    as you cycle through your focus
  1139.        using the ALT + TAB Keybinding.    =head2 Moving Windows
  1140.  
  1141.        Enlightenment comes with    several    different available
  1142.        methods for moving a window.  You can perform the actual
  1143.        moves using the    Window
  1144.  
  1145.        Border, or by using the available
  1146.  
  1147.        Mouse Bindings .     This will cause the window to move until
  1148.        you have    released the mouse button.
  1149.  
  1150.        To change the mode that the moving of the windows uses
  1151.        (opaque being the default), open    up the Settings    menu, and
  1152.        select "Move & Resize Settings".     You can select    from a
  1153.        list that looks similar to the one here above-right.
  1154.        Experiment until    you find one that suits    you best.
  1155.  
  1156.        For some    serious    eyecandy, try out the Translucent move
  1157.        mode.  This will    only work if your X server and
  1158.        Enlightenment are running on the    same machine, however.
  1159.  
  1160.        RRRReeeessssiiiizzzziiiinnnngggg    WWWWiiiinnnnddddoooowwwwssss
  1161.  
  1162.        Enlightenment also comes    with several available methods
  1163.        for resizing windows.  You can perform the actual resize
  1164.        on the window by    clicking on any    resize-handle of your
  1165.        window border and dragging to the desired size.    You can
  1166.        also get    the same effect    by using the ALT + middle button
  1167.        mouse binding in    any part of the    window.
  1168.  
  1169.        To change the mode that the resizing of the windows uses
  1170.        (opaque being the default), open    up the Settings    menu, and
  1171.        select "Move & Resize Settings".     You can select    from a
  1172.        list that looks similar to the one here above-right.
  1173.        Experiment until    you find one that suits    you best.
  1174.  
  1175.        The best    eyecandy resize    mode is    probably technical move
  1176.        mode.  This mode    shows you the height and width of the
  1177.        window, in addition to the distance from    the nearest edge.
  1178.  
  1179.        The Window Operations Menu The Window Operations    menu is    a
  1180.        commonly    used menu that allows you to perform many
  1181.        different actions onto the current window.
  1182.  
  1183.  
  1184.  
  1185.  
  1186. 2000-09-28           Enlightenment 0.16.4               18
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192. ENLIGHTENMENT(1)     Enlightenment Man Pages     ENLIGHTENMENT(1)
  1193.  
  1194.  
  1195.        The Close function closes the window in question.
  1196.        Annihilate destroys the window without regard to    the
  1197.        application the window belongs to, which    is especially
  1198.        useful if the application refuses to respond to being
  1199.        closed with Close.
  1200.  
  1201.        The Iconify function iconifies the window.  If you have an
  1202.  
  1203.        Iconbox it is sent to the nearest one.
  1204.  
  1205.        The Raise function raises the window above any windows
  1206.        that may    be obscuring it    and Lower lowers it below windows
  1207.        it is obscuring.
  1208.  
  1209.        Shade/Unshade toggles the shaded    state of the window. Note
  1210.        that borderless windows are not allowed to be shaded.
  1211.  
  1212.        Stick/Unstick toggles the sticky    state of a window. A
  1213.        window that is sticky remains "stuck to the glass" and
  1214.        thus is visible on all virtual and multiple desktops.
  1215.  
  1216.        Fullscreen/Window zooms in and out of the window    changing
  1217.        resolutions if possible.    This feature will only work if
  1218.        you have    your X server configured correctly and it
  1219.        supports    the XVidtune extension.    Your X server may not
  1220.        like having resolutions changed - it is possible    that an
  1221.        unstable    X server could crash if    you use    this. Be aware of
  1222.        this when using this feature.
  1223.  
  1224.        Remember... displays the    Remember Properties dialog that
  1225.        lets you    select things to remember about    this instance of
  1226.        an application. The attributes selected to be remembered
  1227.        in the state they are when you hit Apply    or Ok in this
  1228.        dialog. You will    have to    bring it up again if you wish to
  1229.        remember    a new state of the window.
  1230.  
  1231.        In the Window Groups submenu there are various options for
  1232.        configuring window groups and how this window relates to
  1233.        any groups you may have.    Note that you cannot group Pagers
  1234.        windows or Iconboxes together with each other or    any other
  1235.        windows.
  1236.  
  1237.        You can quickly modify the size of a window to one of
  1238.        several aspects of maximum sizes    using the Window Size
  1239.        submenu.
  1240.  
  1241.        Set Stacking lets you change the    stacking layer of that
  1242.        window.
  1243.  
  1244.        You can change the border using the Set Border Style menu
  1245.        if you wish to use a different window border. If    you
  1246.        change themes after you have changed the    border,    and the
  1247.        new theme doesn't provide a border of the same name, the
  1248.        window will fall    back to    using the DEFAULT border until
  1249.  
  1250.  
  1251.  
  1252. 2000-09-28           Enlightenment 0.16.4               19
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258. ENLIGHTENMENT(1)     Enlightenment Man Pages     ENLIGHTENMENT(1)
  1259.  
  1260.  
  1261.        you change it again.
  1262.  
  1263.        Setting up E to work with KDE and GNOME Enlightenment,
  1264.        though it strives to be its own desktop environment, also
  1265.        supports    KDE and    GNOME desktop environments wherever
  1266.        possible.  Enlightenment    comes set up to    support    GNOME out
  1267.        of the box, in fact. To enable the KDE hints, however, you
  1268.        must launch Enlightenment and then go into the "KDE
  1269.        Support Settings" section of your Settings menu.     From
  1270.        here you    can enable or disable KDE support in your copy of
  1271.        Enlightenment.    This setting will automatically    save for
  1272.        the next    time you launch    Enlightenment.    You should be
  1273.        able to launch any of KDE's or GNOME's applications and
  1274.        have them supported fairly well,    including (but not
  1275.        limited to) the panel or    kpanel,    and gmc    and kfm.
  1276.  
  1277.        Please see the Frequently Asked Questions for more
  1278.        information on how to set up enlightenment to work with
  1279.        GNOME and KDE by    default.
  1280.  
  1281.        Window Placement    and Autoraise
  1282.  
  1283.        These two Settings dialogs allow    you to configure various
  1284.        options for the placement of windows.  The two Dialog
  1285.        window options are for windows like the ALT+O open URL
  1286.        window in Netscape.  Manual Placement will force    you to
  1287.        use the mouse to    position every new window that attempts
  1288.        to map itself.
  1289.  
  1290.        The Autoraise settings Dialog will allow    you to set a
  1291.        timer event that    causes a window    to automatically raise
  1292.        itself to the foreground    after a    set time.  You can enable
  1293.        it here,    as well    as change the timer.  This is only useful
  1294.        in the sloppy and pointer focus modes.
  1295.  
  1296.        Enlightenment and IPC
  1297.  
  1298.        Enlightenment has a fairly interesting IPC system that
  1299.        allows external applications (such as Eterm) to talk to
  1300.        Enlightenment and both ask for information and change
  1301.        information.  There is a    program    that was installed with
  1302.        Enlightenment called "eesh" that    is a simple shell
  1303.        interface to the    IPC in Enlightenment.  It's even got its
  1304.        own documentation.  You can go into eesh    and type "help"
  1305.        and it should spit back a list of commands that it
  1306.        understands.
  1307.  
  1308.        Note: there are many commands that will show up in E's IPC
  1309.        that don't necessarily work yet,    or aren't fully
  1310.        implemented.  You CAN potentially do some really    bizarre
  1311.        things to your system by    using eesh, but    for the    most part
  1312.        it's just another interesting interface to E.  In your
  1313.        distribution package you    should have received some sample
  1314.        scripts written in Perl that interface to E through eesh
  1315.  
  1316.  
  1317.  
  1318. 2000-09-28           Enlightenment 0.16.4               20
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324. ENLIGHTENMENT(1)     Enlightenment Man Pages     ENLIGHTENMENT(1)
  1325.  
  1326.  
  1327.        showing how you can externally script E to do more things
  1328.        outside E's base    functionality.    Expect the IPC to flesh
  1329.        out even    more in    future revisions.
  1330.  
  1331.        To exit eesh, hit CTRL +    D (EOF)
  1332.  
  1333.        Editing Enlightenment's Menus
  1334.  
  1335.        The first time you run Enlightenment as a user after
  1336.        you've installed    it, it should create a directory under
  1337.        your home directory called .enlightenment.  In this
  1338.        directory, there    will be    a file called "file.menu" - this
  1339.        file controls the contents of your left-mouse button Menu
  1340.        .  The very first line of this file contains the    title for
  1341.        the menu, and the remainder of the file looks something
  1342.        like this:
  1343.  
  1344.        "Eterm" NULL    exec "Eterm"
  1345.  
  1346.        Where each column represents:
  1347.  
  1348.        Entry title , graphic for menu (or NULL) , exec "commandline"
  1349.  
  1350.        You may have several files in here, including a KDE menu
  1351.        and a Gnome menu    if Enlightenment has detected their
  1352.        presence    during installation.  If detected, your    primary
  1353.        apps will be located in another file called
  1354.        user_apps.menu.    Each of    these files is for you to edit as
  1355.        desired.
  1356.  
  1357.        EEEEddddiiiittttiiiinnnngggg YYYYoooouuuurrrr KKKKeeeeyyyybbbbiiiinnnnddddiiiinnnnggggssss
  1358.  
  1359.        To set your own keybindings, all    you have to do is find
  1360.        the keybindings.cfg file    that was installed with
  1361.        Enlightenment, and make a copy in your ~/.enlightenment
  1362.        directory.  This    file is    fairly long, but shouldn't be too
  1363.        difficult to edit.  Be careful!    The keybindings    in this
  1364.        file will override ALL the default keybindings, as long as
  1365.        this file exists, so edit this file with    extreme    caution
  1366.        (unless you know    what you're doing).
  1367.  
  1368.        To reset    your keybindings back to the default, simply
  1369.        remove this file    from your ~/.enlightenment directory.
  1370.        The next    time you restart Enlightenment it should reload
  1371.        the default keybindings into memory.
  1372.  
  1373.        Enlightenment and Themes
  1374.  
  1375.        One of the strong points    of Enlightenment, of course, is
  1376.        that you    can change around the complete look and    feel of
  1377.        your desktop whenever you want to.  Included with the
  1378.        0.16.5 release are a few    themes,    to show    off a little bit
  1379.        of this configurability.     You can select    them by    using the
  1380.        middle mouse button menu    , going    to the "Themes"    selector,
  1381.  
  1382.  
  1383.  
  1384. 2000-09-28           Enlightenment 0.16.4               21
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390. ENLIGHTENMENT(1)     Enlightenment Man Pages     ENLIGHTENMENT(1)
  1391.  
  1392.  
  1393.        and then    choosing a new theme.  Of course, there    are
  1394.        plenty more themes for Enlightenment than come with it by
  1395.        default.     You can find more by going to:
  1396.  
  1397.        http://e.themes.org
  1398.  
  1399.        and searching around until you find something you like.
  1400.  
  1401.        To install a new    theme is simple: all you need to do is
  1402.        take the    bleh.etheme file and drop it into your
  1403.        ~/.enlightenment/themes directory.  Once    you've restarted
  1404.        Enlightenment, it will automatically show up in your
  1405.        Themes menu, and    you can    choose it just like any    other
  1406.        theme.
  1407.  
  1408.        Enlightenment's Eyecandy    Features
  1409.  
  1410.        Of course, Enlightenment    wouldn't be complete without just
  1411.        a few bits of eyecandy to play with.  Access them from the
  1412.        "Desktop" portion of your middle    mouse button menu.  There
  1413.        are two toys that you can choose    from:
  1414.  
  1415.        The ripples effect - this causes    little ripplets    of water
  1416.        to reflect on the bottom    of your    screen.
  1417.  
  1418.        The waves effect    - similar to ripples, but this one waves
  1419.        up and down as opposed to side-to-side
  1420.  
  1421.        Each of these can be turned back    off simply by using the
  1422.        same menu that you enabled it through.
  1423.  
  1424.        IIIInnnncccclllluuuuddddeeeedddd    MMMMaaaaiiiinnnntttteeeennnnaaaannnncccceeee SSSSccccrrrriiiippppttttssss
  1425.  
  1426.        Enlightenment comes with    several    scripts    that are
  1427.        executable out of the middle mouse button menu -    these
  1428.        scripts can perform all sorts of    maintenance on the files
  1429.        that Enlightenment creates automatically    for you.  When
  1430.        you select "Maintenance"    you should get a menu that looks
  1431.        something like the one above-right.  You    can also rebuild
  1432.        the KDE and GNOME menus Enlightenment uses from here
  1433.  
  1434.        As a warning, when you purge configuration information,
  1435.        the next    time you restart Enlightenment it will take
  1436.        longer to load.    You can    monitor    Enlightenment's    usage
  1437.        using the query tools provided.    If you change themes a
  1438.        lot you will probably want to purge the config file cache
  1439.        after you've settled on a theme.     This will help    keep your
  1440.        disk usage by Enlightenment down.
  1441.  
  1442.        FFFFrrrreeeeqqqquuuueeeennnnttttllllyyyy AAAAsssskkkkeeeedddd    QQQQuuuueeeessssttttiiiioooonnnnssss
  1443.  
  1444.        Q: I can't find my Iconbox or change its    settings.
  1445.  
  1446.        A: There    are two    possibilities here.
  1447.  
  1448.  
  1449.  
  1450. 2000-09-28           Enlightenment 0.16.4               22
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456. ENLIGHTENMENT(1)     Enlightenment Man Pages     ENLIGHTENMENT(1)
  1457.  
  1458.  
  1459.        1. You don't have an Iconbox on your desktop right now.
  1460.        Just middle-click and select Desktop/Create new iconbox
  1461.  
  1462.        2. Your Iconbox is transparent and borderless.  Iconify a
  1463.        window and see if your icon appears.  If    so, rightclick on
  1464.        it to reconfigure your Iconbox.
  1465.  
  1466.        Q:  I Can't Seem    To Find    My Left    Mouse Menu
  1467.  
  1468.        A:  Your    menu files may be destroyed.  Try rerunning the
  1469.        program that initially generated    them.  First you'll want
  1470.        to remove the ~/.enlightenment/*.menu files.  Rebuild them
  1471.        using the Maintenance menu.
  1472.  
  1473.        Q:  All My Settings Are Mangled And I Can't Fix It
  1474.  
  1475.        A:  Well, if things get really messed up, you can always
  1476.        remove all of Enlightenment's automatically saved files.
  1477.        go into ~/.enlightenment, and remove the    ...e_session*
  1478.        files, and then blow away the cached directory.    If your
  1479.        theme is    broken,    remove the user_theme.cfg file,    also.
  1480.        The next    time you start Enlightenment it    should reset
  1481.        everything to the default.
  1482.  
  1483.        Q: I Upgraded My    Theme, But The New One Isn't Being Used
  1484.  
  1485.        A: When you upgrade a theme that    does not come with
  1486.        Enlightenment, when you go into your
  1487.        ~/.enlightenment/themes directory, be sure to delete the
  1488.        unpacked    directory version of your theme    that should be
  1489.        sitting next to the theme, if it    is there.  Otherwise when
  1490.        Enlightenment attempts to start the new version it will
  1491.        use the old files, which    causes this problem.
  1492.  
  1493.        Q:  I set my window to borderless and can't set it back or
  1494.        move it.
  1495.  
  1496.        A:  ALT + Right mouse button when pressed anywhere in the
  1497.        window will give    you the    window operations menu.    ALT +
  1498.        Left mouse button will move the window and ALT +    Middle
  1499.        mouse button will resize    the window.
  1500.  
  1501.        Q: How can I move or resize the iconbox?
  1502.  
  1503.        A: As described above, ALT + Right mouse    button will give
  1504.        you the window operations menu, ALT + Middle mouse button
  1505.        will resize the iconbox and ALT+left mouse button will
  1506.        move it.     See the Iconbox documentation for more    help
  1507.  
  1508.        Q: How can I disable that annoying desktop tooltip?
  1509.  
  1510.        A: There    is a special config option for it under    the
  1511.        tooltip settings    menu.
  1512.  
  1513.  
  1514.  
  1515.  
  1516. 2000-09-28           Enlightenment 0.16.4               23
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522. ENLIGHTENMENT(1)     Enlightenment Man Pages     ENLIGHTENMENT(1)
  1523.  
  1524.  
  1525.        Q: How do I set up Enlightenment    to work    with GNOME?
  1526.  
  1527.        A: By default, Enlightenment supports all of the    GNOME
  1528.        hints.  However,    if you want to run GMC you may notice
  1529.        that clicking on    the root window    does not always    have the
  1530.        desired effect (for dragging icons, GMC's root menus,
  1531.        etc).  If you want to use GMC with enlightenment, there
  1532.        are a couple of options.     You can use alt+leftmouse and
  1533.        alt+rightmouse to use the GMC root menus.  Or, you can
  1534.        edit the    keybindings.cfg    file to    remove the bindings for
  1535.        your left and right mousebuttons.  There    is a copy of
  1536.        keybindings.cfg that will do this for you that comes with
  1537.        enlightenment.  in /path/to/enlightenment/configs/ copy
  1538.        the keybindings.gmc.cfg into your ~/.enlightenment
  1539.        directory.  When    you restart, you will no longer    have the
  1540.        left and    right mousebuttons bound to enlightenment.  To
  1541.        modify your system configuration, copy over the
  1542.        keybindings.cfg file in that directory.    For your
  1543.        convenience, there is a keybindings.nogmc.cfg in    case you
  1544.        want to reverse this change at a    later date.  NOTE: you
  1545.        may choose to use virtual areas instead of virtual
  1546.        desktops    since GMC does not handle clicks anywhere on the
  1547.        root window on desktops other than 0.  If you want to
  1548.        start enlightenment from    gnome-session, you should use the
  1549.        gnome control-panel to select the new enlightenment as
  1550.        your window manager.  Warning: Enlightenment is slower
  1551.        when run    from a session manager.     You should opt    to run
  1552.        enlightenment and have enlightenment be your session
  1553.        manager instead of running gnome-session.  You can start
  1554.        "panel" and "gmc" by hand and have enlightenment    relaunch
  1555.        them as the preferred launch method.  To    do this, once you
  1556.        have launched them by hand, alt-rightclick on them, select
  1557.        "Remember" and then choose "Restart Application on Login".
  1558.  
  1559.        Q: How do I set up Enlightenment    to work    with KDE ?
  1560.  
  1561.        A: By default, Enlightenment does not support the KDE
  1562.        hints.  You can turn them on easily through your    settings
  1563.        menus, however.    If you want to add support automatically
  1564.        upon launch (which can be disabled by the autosaved user
  1565.        configuration) then copy    the control.kde.cfg to the
  1566.        ~/.enlightenment    directory and rename it    to control.cfg.
  1567.        If you are doing    this after launching enlightenment for
  1568.        the first time, you will    want to    remove the line    from your
  1569.        ~/.enlightenment/...e_session.XXXXXX file that looks like:
  1570.        1366 0 simply remove that line and start    up enlightenment
  1571.        again.  If your "KDE Support" settings panel still show
  1572.        KDE support turned on, then you can simply check    the box
  1573.        there, and KDE support will remain on.  You can launch
  1574.        kpanel and/or kfm from your .xsession or    .xinitrc files
  1575.        and they    will work correctly.  If you want to edit the
  1576.        startkde    script (system-wide configuration change) find
  1577.        the line    that contains kwm and replace it with
  1578.        /path/to/enlightenment.
  1579.  
  1580.  
  1581.  
  1582. 2000-09-28           Enlightenment 0.16.4               24
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588. ENLIGHTENMENT(1)     Enlightenment Man Pages     ENLIGHTENMENT(1)
  1589.  
  1590.  
  1591.        Q:  These Docs Didn't Help, Where Can I Get More    Help?
  1592.  
  1593.        A: Well,    we obviously can't answer all of your questions
  1594.        just by predicting them,    so I would try the website as
  1595.        well as looking at the mailing lists , especially the mail
  1596.        archives.  Chances are that someone else    has probably had
  1597.        the same    problem    that you have.    And if all that    still
  1598.        fails, you might    try someone on the irc channel
  1599.  
  1600. FFFFOOOORRRR MMMMOOOORRRREEEE IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  1601.        Please see our web site at http://www.enlightenment.org
  1602.  
  1603.  
  1604.  
  1605.  
  1606.  
  1607.  
  1608.  
  1609.  
  1610.  
  1611.  
  1612.  
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648. 2000-09-28           Enlightenment 0.16.4               25
  1649.  
  1650.  
  1651.